home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Utilities / uupc 3.1 / (old support files) / Read me! < prev    next >
Encoding:
Text File  |  1989-11-20  |  6.4 KB  |  135 lines  |  [TEXT/KAHL]
  1.  
  2. Please read the UUPC distribution notes in the (Support) folder. These
  3. are very brief notes aimed at expert users.
  4.  
  5. Installation
  6.  
  7. You probably won't make much sense of what follows unless you have installed
  8. uucp on a Unix system before. Both pcmail and uupc read the resource file
  9. "Profile" to get its configuration information. There are sample config files
  10. in the (Support) folder. Edit the sample "Profile" in this package to reflect
  11. your environment. It just contains a set of STR resources that provide a quick
  12. and dirty simulation of Unix environment variables. Examine the file using
  13. ResEdit: I think you will find it self-explanatory. In essence, uupc needs to
  14. know where to find spool files, and so on. I suggest you use full pathnames
  15. (unix style with slashes) all the time. There are a set of defaults compiled
  16. into the programs. They are
  17.  
  18.     MAILBOX        "Postmaster"        current user's "id"
  19.     NAME        "System admin"      current user's full name
  20.     HOME        "guest"             current user's home dir
  21.     DOMAIN        "mac.uucp"          domain name of this machine
  22.     MAILDIR        "spool/mail"        where mail is kept
  23.     CONFDIR        "lib/uucp"          where config data is kept
  24.     SPOOLDIR    "spool/uucp"        where spooled files are kept
  25.     PUBDIR        "spool/uucppublic"  public spool directory
  26.     MAILSERVICE    "host"              who do we send remote mail
  27.     NODENAME    "mac"               what is our local nodename
  28.     DEVICE        "modem"             what is the default device
  29.     SPEED        "1200"              what is the default speed
  30.     TEMPDIR        "spool/tmp"         what is temp directory
  31.     MAILCOPY    "mail.sent"         file to record outgoing mail
  32.                                     (null string disables)
  33.     SIGNATURE   ".signature"        file containing signature lines
  34.     TIMEDIFF    "GMT"               time difference from GMT (a string)
  35.  
  36. One of the config items, "CONFDIR", tells uupc where to find the "Systems"
  37. file. This is the equivalent of uucico's L.sys file, and you should edit the
  38. enclosed sample file and put it in your CONFDIR. Use "printer" or "modem"
  39. (or .a or .b) to specify which port to use. I have not tested the Hayes
  40. dialling code, preferring to use the send-expect strings to control the
  41. modem (see the enclosed sample Systems file).
  42.  
  43. Uupc/pcmail will create the file SEQF in the CONFDIR; this is a simple text
  44. file that maintains the sequence number. The SPOOLDIR is used for obvious
  45. purposes, and logfiles are also created there. There are various folders for
  46. temporary files. You can also specify the mail host, your mail domain name,
  47. the signature file (a text file that is appended to all your messages), and a
  48. mail dir in which your mail boxes are kept.
  49.  
  50. For users
  51.  
  52. There are two applications included in this package: pcmail, used to generate
  53. mail, and uupc used to transfer it. Pcmail has not been extensively tested; in
  54. particular, the mail reading interface does not work. Composing mail is ok if
  55. brain-damaged. It just uses the Think stdio libaries, so you have to type in
  56. the message. Fortunately, you can use any Mac text editor to compose your mail
  57. and either (a) redirect stdin or (b) copy and paste it in. I read my mail
  58. using a text editor, and generate my replies using same. I have not spent much
  59. time on pcmail as I would rather spend the time writing a Mac-like mail
  60. front-end.
  61.  
  62. Mail that you send is put in a spool directory, and "Mac uupc" is used to send
  63. the mail to your mailfeed, and to poll your mailfeed for incoming mail. At
  64. present, you have to kick off uupc manually although I suppose something like
  65. Quickeys 1.2 could be used for automatic overnight polls.
  66.  
  67. Some details:
  68. a) To send mail: dbl-click pcmail. Then type in the address to which you
  69.    want to send mail followed by the mail message. A mail message consists
  70.    of header line, then a blank line, then the body of the message.
  71.    Pcmail adds the To:, From: and Date: lines to your message header,
  72.    but not the Subject: line. You can add any header lines you want to
  73.    your message. The mail message can be pasted in from the clipboard or
  74.    you can redirect standard input. Eg.
  75.    
  76.    info-mac@sumex.aim.edu < my_message
  77.    
  78.    where my_message is a text file contain the message. Alternatively,
  79.    you can type or paste your message from the clipboard:
  80.    
  81.    info-mac@sumex.aim.edu
  82.    Subject: A message
  83.    
  84.    Here is a message.....
  85.    
  86. b) To transfer mail: dbl-click "Mac uupc" and type in the command line you
  87.    would have typed to uucico on Unix. E.g.
  88.    
  89.    -smailhost -r1 -x4
  90.    
  91.    to poll host "mailhost" in master mode and debugging level 4. Information
  92.    about how to call "mailhost" is stored in the file "Systems" (see above).
  93.    Uupc will transfer any files spooled on your machine to your host and pick
  94.    up any mail waiting for you there.
  95.  
  96. For hackers
  97.  
  98. I tried to use the scheme in the UUPC distribution in which the common source
  99. files were kept in a folder one level above Mac-specific ones, and were
  100. "#included" by the system-specific files. Unfortunately, Think C wouldn't let
  101. me #include a full pathname (I think this is fixed in Think C 4.0), so that
  102. went out the door. Instead I keep the project files, and any common source
  103. files in the top-level folder and source files in their respective folders.
  104. I've also changed some of the mail headers to bring them into line with what
  105. sendmail on Unix generates. The original author has not approved this and I
  106. hope he doesn't mind.
  107.  
  108. Wherever possible, I tried to use stdio functions, and kept Mac-specific
  109. changes to files in the Mac-specific folder. If you are recompiling the
  110. sources, you should enable the "paste from clipboard" option in the stdio
  111. libraries (look in the stdio sources). Also there's a problem with "freopen".
  112. Look in the file "stdopen fix" i the (Support) folder for details. I've also
  113. changed some of the logging files to make them close to Unix uucp LOGFILEs,
  114. and also added code for the SYSLOG logfile. I also added two functions to
  115. pcmail to turn addresses into either uucp "!" form or "%@" form. My mail host
  116. is somewhat fussy about what addresses you give it, and yours may be as well;
  117. #define PERCENT_ADDRS as needed (in lmail.c). This is only done on outgong
  118. mail, by the way.
  119.  
  120. To do
  121.  
  122. Lots; e.g. a decent mail front-end, MF friendly background xfers, conversion to
  123. a full-blown Mac application ...
  124.  
  125. Good luck!
  126. Sak Wathanasin
  127. Network Analysis Limited
  128.  
  129. uucp:   ...!ukc!nan!sw
  130. other:  sw%nan.uucp@ukc.ac.uk
  131. phone:  (+44) 242 520861
  132. telex:  9312130355 (SW G)
  133. snail:  Flat 4, Albany House, Lansdown Rd, Cheltenham, Glos GL50 2HY, UK
  134.  
  135.